home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 3 / Cream of the Crop 3.iso / clipper / ks94an.zip / PRNTFILE.HDR < prev    next >
Text File  |  1994-04-25  |  3KB  |  94 lines
  1. /******************************************************************************
  2.                  The Klipper Library, for CA-Clipper 5.x
  3.         Copyright (c), 1994, Wallace Information Systems Engineering
  4.  
  5. FUNCTION:
  6.  
  7. _Print_File(cFileName,nLinesPerPage,nPageNum,cExcludeText,lPageNum,lDate,lLin
  8. eNums) --> NIL
  9.  
  10. PARAMETERS:
  11.  
  12. cFileName     : Text File to Print
  13. nLinesPerPage : Lines per page (Default 66)
  14. nPageNum      : Beginning Page Number
  15. cExcludeText  : Text criteria to Exclude Lines
  16. lPageNum      : Logical - print page numbers if TRUE
  17. lDate         : Logical - print date on page header if TRUE
  18. lLineNums     : Logical - Print Line numbers if TRUE
  19.  
  20. SHORT:
  21.  
  22. Print text to printer (HP LaserJet formatting).
  23.  
  24. DESCRIPTION:
  25.  
  26. _Print_File() prints a DOS text file (Source Code, etc) on an HP Laser
  27. Jet specifically.
  28.  
  29. If the nLinesPerPage argument is not supplied, the default is 55 lines
  30. per page.
  31.  
  32. If lDate is not specified, the default is TRUE (print date).
  33.  
  34. If the nPageNum argument is supplied, page numbering begins with that
  35. value, and the internal page number is set to that value also
  36. (subsequent calls to _Print_File() will continue with that page number).
  37.  
  38. If nPageNum is NOT supplied, the function looks first for it's internal
  39. page number and if present, uses it.  If the nPageNum argument is not
  40. supplied and there is no internal page number yet established, page
  41. numbering begins with 1 and 1 becomes the internal page number.
  42.  
  43. The internal page number is stored in PAGENUM.MEM, thus allowing
  44. subsequent calls to _Print_File() to maintain page numbers across
  45. multiple files.  To reset page numbering, either specify the new
  46. beginning page number in nPageNum, or deleted the PAGENUM.MEM file.
  47.  
  48. If cExcludeText is not specified, all lines of text are printed.
  49.  
  50. If cExcludeText IS specified, any line in the input file that contains
  51. the text specified in cExcludeText, is skipped.
  52.  
  53. This function is expicitly designed to work with the HP LaserJet II/III
  54. and the font is set to:
  55.  
  56.     CPI        : 16.67  (Condensed)
  57.     LPI        : 6
  58.     Point Size : 8.5
  59.     Style      : Upright
  60.     Stroke     : Medium
  61.     Typeface   : Line Printer
  62.     Orient     : Port
  63.     Left Margin: 5
  64.  
  65. These settings can collectively be refered to as Internal Font I001 on the
  66. HP LaserJet III.
  67.  
  68. For a Generic Printer see: PRNTTEXT.PRG: _Print_Text()
  69.  
  70. _Print_File() makes no check on the printer status  output is set to print
  71. and the first line is written.  The programmer must make sure there is
  72. a printer available before calling _print_file().
  73.  
  74. NOTE:
  75.  
  76.  
  77.  
  78. EXAMPLE:
  79.  
  80. _Print_File('File1.txt',,1)
  81. _Print_File('File2.txt')
  82.  
  83. Result: File1.txt is printed, beginning page numbers at 1, and then
  84. FILE2.TXT is printed, CONTINUING page numbers from FILE1.TXT (whatever
  85. that page number may be).
  86.  
  87. _Print_File('File1.txt',,1)
  88. _Print_File('File2.txt',,1)
  89.  
  90. Result: FILE1.TXT is printed, beginning page numbering at 1, and then
  91. FILE2.TXT is printed, ALSO beginning page numbering at 1.
  92.  
  93. ******************************************************************************/
  94.